home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / ash16.zip / ASH16U.DOC < prev    next >
Text File  |  1992-10-18  |  10KB  |  227 lines
  1.  
  2.  
  3.  
  4.  
  5.                            Alchemy Shell 1.6
  6.  
  7.                 A graphical shell for Image Alchemy 1.6
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                    by Edwin Groothuis, Augustus 1992
  24.  
  25. «« What is Alchemy Shell?
  26.  
  27.    This program is a graphical shell for Image Alchemy 1.6 of Handmade
  28.  Software. I wrote this shell because I was tired of searching for the
  29.  correct parameters that Alchemy needed for correct conversion.
  30.  
  31.    This program is shareware. It may not be spread without documentation
  32.  or sold for more than US$ 3.-. It may be spread free via bulletin board
  33.  systems, Internet or other public networks. If you distribute it as part
  34.  of a shareware-disk, please let me know.
  35.  
  36.    For information about registering see below.
  37.  
  38. «« What is required for Alchemy Shell?
  39.  
  40.    Alchemy Shells requires three things:
  41.  o A IBM-compatible computer with compatible VGA-card. (This program uses
  42.    videomode 12h. It's a standard VGA-mode)
  43.  o A mouse and mousedriver. Most computers today have this.
  44.  o The program Image Alchemy 1.6 (called ALCHEMY.EXE). Please put
  45.    ALCHEMY.EXE and ASH.EXE in the same directory, since ASH.EXE searches
  46.    for ALCHEMY.EXE only in the same directory as ASH.EXE is.
  47.  
  48. «« How to use Alchemy Shell?
  49.  
  50.    To run Alchemy Shell, type ASH with as optional parameter the sourcefile.
  51.  Now you get a graphical screen with several windows like this:
  52.  
  53.  ┌─────────────────────────────────────────────────────────────────────────┐
  54.  ├─────────────────────────────────────────────────────────────────────────┤
  55.  │                 A┌────────┐B┌───┐              ┌───────────────┬─┐K     │
  56.  │   Sourcefile     └────────┘ └───┘              │J              ├─┤      │
  57.  │                 C┌────────┐                    │               │ │      │
  58.  │   Destination    └────────┘                    │               │ │      │
  59.  │                 D┌─┬E┬─┐F                      │               │ │      │
  60.  │   Colorbits      └─┴─┴─┘                       │               │ │      │
  61.  │                 G┌───┐                         │               │ │      │
  62.  │   XSize          └───┘                         │               │ │      │
  63.  │                 H┌───┐                         │               │ │      │
  64.  │   YSize          └───┘                         │               │ │      │
  65.  │                 I┌─┐                           │               │ │      │
  66.  │   Overwrite      └─┘                           │               ├─┤      │
  67.  │                                                └───────────────┴─┘L     │
  68.  │        ┌────────────────┐               ┌────────────────┐              │
  69.  │        │     G O        │               │    CANCEL      │              │
  70.  │        │               M│               │               N│              │
  71.  │        └────────────────┘               └────────────────┘              │
  72.  │                                                                         │
  73.  └─────────────────────────────────────────────────────────────────────────┘
  74.  
  75.  Legend:
  76.    A: Click here to change the name of the sourcefile.
  77.       After clicking the (old) name will disappear and you can enter a
  78.       new name. Finishing with ENTER (accept name) or ESCAPE (keep old name).
  79.       After typing 13 characters (=a complete filename) the inputline
  80.       will automatic close.
  81.    B: Browse for a file. See below
  82.    C: Click here to change the name of the destinationfile. See also A.
  83.    E: Selected number of colorbits. Possible are 8, 15, 16, 24 or 32 bits.
  84.       Some images require only 8 colorbits (like the GIF-format),
  85.       some images can handle more colorbits (like the TIFF-format).
  86.    D,F: Select previous or next number of colorbits.
  87.    G: Click here for a new image-width. This can be up to 9999 pixels.
  88.       (Note: The unregistered version of Image Alchemy can only handle up
  89.        to 640x480 pixels).
  90.       After clicking the (old) X-Size will disappear and you can enter
  91.       a new X-Size. Finishing with ENTER (accept new size) or
  92.       ESCAPE (keep old size). After typing four digits (=maximal number
  93.       of digits) the inputline will automatic close.
  94.    H: Click here for a new image-height. See also G.
  95.    I: Click here if you want to toggle overwrite. Image Alchemy normally
  96.       requires the parameter -o to overwrite. If you don't want to overwrite
  97.       a old file, please click here. The "√" will disappear.
  98.    J: List of new image-formats. Click on one to choose the new format.
  99.       After clicking, the extension of the destinationfile will automatic
  100.       be converted to the "normal" extension of that image-format.
  101.    K,L: Click here for going higher or lower in the list. If you can't
  102.       go any further, you'll here a beep.
  103.    M: GO: start conversion and go back to dos.
  104.    N: cancel: cancel conversion, go back to dos.
  105.  
  106. «« Browse for a file.
  107.  
  108.    After clicking on B, a new window will appear:
  109.  
  110.  ┌─────────────────────────────────────────────────────────────────────────┐
  111.  ├─────────────────────────────────────────────────────────────────────────┤
  112.  │   ┌─────────────────────────────────────────────────────────────────┐   │
  113.  │   ├────────────────────────────────────────────────────O┬───────────┤   │
  114.  │   │S                                                   P├───────────┤   │
  115.  │   │                                                     ├───────────┤   │
  116.  │   │                                                    Q├───────────┤   │
  117.  │   │                                                     │   o k     │   │
  118.  │   │                                                     ├───────────┤   │
  119.  │   │                                                    R├───────────┤   │
  120.  │   │                                                     │  cancel   │   │
  121.  │   │                                                     ├───────────┤   │
  122.  │   │                                                     │           │   │
  123.  │   │                                                     │           │   │
  124.  │   │                                                     │           │   │
  125.  │   │                                                     │           │   │
  126.  │   │                                                     │           │   │
  127.  │   │                                                     │           │   │
  128.  │   │                                                     │           │   │
  129.  │   └─────────────────────────────────────────────────────┴───────────┘   │
  130.  └─────────────────────────────────────────────────────────────────────────┘
  131.  Legend
  132.    O: Change the searchmask to *.*
  133.    P: Choose a custommask (wildchards etc. are allowed). See alse A
  134.    Q: Click here when you've choosen the correct file. On the mainwindow,
  135.       the name of the sourcefile will change into the selected file and
  136.       the name of the destinationfile with the correct extension.
  137.    R: Click here to cancel the browse-menu
  138.    S: Here are the names of the files in the current directory that
  139.       match the gives mask. Click on one to choose.
  140.  
  141. «« After typing GO
  142.  
  143.    When you've clicked on GO, the graphical screen will disappear and the
  144.  normal textscreen will appear. The program Image Alchemy is automatic
  145.  executed with the selected parameters. When your image is converted, the
  146.  normal dos-prompt will return. If Image Alchemy has found any errors, it
  147.  is displayed on the screen by Image Alchemy.
  148.  
  149. «« Known bugs
  150.  
  151.  o Sometimes Image Alchemy will give the warning "options -8, -c2 and -b
  152.    assumed". This can happen if you're converting a image to black-and-white
  153.    images like Postscript, HP PCL and Freedom of Press.
  154.  
  155.  o Alchemy Shell doesn't do a detect for the mouse. Press ESCAPE if your
  156.    mouse doesn't respond.
  157.  
  158. «« Registering
  159.  
  160.  You can register Alchemy Shell by filling in the registerform and
  161.  sending US$ 15,- or more to
  162.      "Alchemy Shell reg."
  163.  p/a Edwin Groothuis
  164.      Johann Strausslaan 1
  165.      5583ZA Aalst-Waalre
  166.      The Netherlands
  167.  
  168.  Please note
  169.   o Cheques must be made payable to Edwin Groothuis
  170.  
  171.   o Payment may be made by sending cash in an envelope (Use registered
  172.     mail!) or by send